Geeft als resultaat een Variant (Long) waarmee het aantal tijdsintervallen tussen twee opgegeven datums wordt aangeduid.
Syntaxis
DateDiff(interval, date1, date2[, firstdayofweek[, firstweekofyear]])
De functie DateDiff heeft de volgende benoemde argumenten:
| Onderdeel | Beschrijving |
|---|---|
| interval | Vereist. Een reeksexpressie die het tijdsinterval aangeeft dat u gebruikt om het verschil tussen date1 en date2 te berekenen. |
| date1, date2 | Vereist. Variant (Date). De twee datums die u in de berekening wilt gebruiken. |
| eerstedagvanweek | Optioneel. Een constante die de eerste dag van de week aangeeft. Als er niets wordt opgegeven, wordt zondag gebruikt. |
| eersteweekvanjaar | Optioneel. Een constante die de eerste week van het jaar aangeeft. Als er niets wordt opgegeven, wordt de week gebruikt waarin 1 januari valt. |
Instellingen
Het argument interval heeft de volgende instellingen:
| Instelling | Beschrijving |
|---|---|
| yyyy | Jaar |
| q | Kwartaal |
| m | Maand |
| y | Dag van het jaar |
| d | Dag |
| w | Dag van de week |
| ww | Week |
| h | Uur |
| m | Minuut |
| s | Seconde |
Het argument firstdayofweek heeft de volgende instellingen:
| Constante | Waarde | Beschrijving |
|---|---|---|
| vbUseSystem | 0 | Gebruikt de NLS API-instelling. |
| vbSunday | 1 | zondag (standaardinstelling) |
| vbMonday | 2 | maandag |
| vbTuesday | 3 | dinsdag |
| vbWednesday | 4 | woensdag |
| vbThursday | 5 | donderdag |
| vbFriday | 6 | vrijdag |
| vbSaturday | 7 | zaterdag |
| Constante | Waarde | Beschrijving |
|---|---|---|
| vbUseSystem | 0 | Gebruikt de NLS API-instelling. |
| vbFirstJan1 | 1 | De week waarin 1 januari valt (standaardinstelling). |
| vbFirstFourDays | 2 | Begint met de eerste week waarvan ten minste vier dagen in het nieuwe jaar vallen. |
| vbFirstFullWeek | 3 | Begint met de eerste week waarvan alle dagen in het nieuwe jaar vallen. |
Notities
U kunt de functie DateDiff gebruiken om vast te stellen hoeveel bepaalde tijdsintervallen tussen twee datums liggen. U kunt DateDiff bijvoorbeeld gebruiken om het aantal weken te berekenen tussen twee datums, of het aantal weken tussen vandaag en het einde van het jaar.
Als u het aantal dagen wilt berekenen tussen date1 en date2 kunt u ofwel Dag van het jaar ('y') gebruiken, ofwel Dag ('d'). Wanneer interval Dag van de week ('w') is, geeft DateDiff het aantal weken tussen de twee datums als resultaat. Als date1 op een maandag valt, telt DateDiff het aantal maandagen tot date2. De functie telt date2 mee, maar niet date1. Als interval echter Week ('ww') is, geeft de functie DateDiff het aantal kalenderweken tussen de twee datums als resultaat. Het aantal zondagen tussen date1 en date2 wordt geteld. Date2 wordt meegeteld als deze op een zondag valt, maar date1 wordt niet meegeteld, ook niet als deze op een zondag valt.
Als date1 naar een later tijdstip verwijst dan date2 geeft de functie DateDiff een negatief getal als resultaat.
Het argument firstdayofweek is van invloed op berekeningen die de intervalsymbolen 'w' en 'ww' gebruiken.
Als datum een letterlijke datum is, wordt het opgegeven jaar een permanent onderdeel van die datum. Indien datum echter is omsloten door dubbele aanhalingstekens (" ") en u het jaar weglaat, wordt het huidige jaar iedere keer dat de expressie datum wordt berekend, in uw code ingevoegd. Hiermee wordt het mogelijk code te schrijven die in verschillende jaren kan worden gebruikt.
Wanneer 31 december wordt vergeleken met 1 januari van het direct daaropvolgende jaar, geeft DateDiff voor Jaar ('yyyy') als resultaat 1, ook al is er slechts ΘΘn dag verstreken.
Opmerking Als de instelling van de eigenschap Calendar voor date1 en date2 Gregoriaans is, moet een Gregoriaanse datum worden opgegeven. Als de kalender Hijri is, moet de opgegeven datum ook Hijri zijn.